Add AGENTS.md with agent etiquette guidelines#24
Draft
apgiorgi wants to merge 2 commits into
Draft
Conversation
Introduces AGENTS.md as the canonical agent/contributor guidance file. Covers agent etiquette (issue-first, no unsolicited PRs, read closed issues), project context, and conventions. CLAUDE.md reduced to a single @AGENTS.md import so all agents read the same source of truth. Co-Authored-By: Claude <noreply@anthropic.com>
…add CONTRIBUTING.md - Single H1 with Etiquette and Project Context as sections - Scope etiquette to external agents so the @AGENTS.md import doesn't block maintainer-directed sessions from implementing changes - Soft-wrap paragraphs to match the repo's markdown style - Add 'Why main.go is a single file' (chapter map, split thresholds) - Add CONTRIBUTING.md so GitHub surfaces the issue-first policy to human contributors
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
AGENTS.mdas the canonical guidance file for any AI agent pointed at this repo — covers etiquette (issue-first, no unsolicited PRs, read closed issues), project context, and conventionsCLAUDE.mdto a single@AGENTS.mdimport so all agents read the same source of truth regardless of which tool they run underWhy
CLAUDE.mdwas Claude Code-specific. Any other agent (Cursor, Codex, Jules, etc.) would ignore it entirely and have no project context or contribution guidance.AGENTS.mdis the emerging cross-tool standard that most agents probe for, while Claude Code picks it up via the@import inCLAUDE.md.The etiquette section addresses the real risk of drive-by agents opening unsolicited PRs or making changes without understanding the broader DCI system context.
Test plan
CLAUDE.mdstill loads full context in a Claude Code session (the@AGENTS.mdimport should pull in everything)AGENTS.mdcontent and wording🤖 Generated with Claude Code
Generated by Claude Code